home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Source Code / Visual Basic Source Code.iso / vbsource / vbdatabs / dllist.h < prev    next >
C/C++ Source or Header  |  1999-03-14  |  9KB  |  305 lines
  1. // ------------------------------- //
  2. // -------- Start of File -------- //
  3. // ------------------------------- //
  4. // ----------------------------------------------------------- //
  5. // C++ Header File Name: dllist.h
  6. // Compiler Used: MSVC40, DJGPP 2.7.2.1, GCC 2.7.2.1, HP CPP 10.24
  7. // Produced By: Doug Gaer
  8. // File Creation Date: 12/29/1996
  9. // Date Last Modified: 03/15/1999
  10. // Copyright (c) 1997 Douglas M. Gaer
  11. // ----------------------------------------------------------- // 
  12. // ---------- Include File Description and Details  ---------- // 
  13. // ----------------------------------------------------------- // 
  14. /*
  15. The VBD C++ classes are copyright (c) 1997, by Douglas M. Gaer.
  16. All those who put this code or its derivatives in a commercial
  17. product MUST mention this copyright in their documentation for
  18. users of the products in which this code or its derivative
  19. classes are used. Otherwise, you have the freedom to redistribute
  20. verbatim copies of this source code, adapt it to your specific
  21. needs, or improve the code and release your improvements to the
  22. public provided that the modified files carry prominent notices
  23. stating that you changed the files and the date of any change.
  24.  
  25. THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.
  26. THE ENTIRE RISK OF THE QUALITY AND PERFORMANCE OF THIS SOFTWARE
  27. IS WITH YOU. SHOULD ANY ELEMENT OF THIS SOFTWARE PROVE DEFECTIVE,
  28. YOU WILL ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR, OR
  29. CORRECTION.
  30.  
  31. A generic doubly linked list class derived from the DNodeBase
  32. class and the DLListBase class.
  33. */
  34. // ----------------------------------------------------------- //   
  35. #ifndef __DLLIST_HPP
  36. #define __DLLIST_HPP
  37.  
  38. #include "dllistb.h"
  39.  
  40. // (D)oubly Linked List (N)ode class 
  41. template<class TYPE>
  42. class DNode : public DNodeBase
  43. {
  44. public:
  45.   DNode() { } // Implicitly call default constructor for Data
  46.   DNode(const TYPE &X) : Data(X) { } // Call copy constructor
  47.  
  48. public:
  49.   DNode<TYPE> *GetPrior() { return (DNode<TYPE> *)Prior; }
  50.   const DNode<TYPE> *GetPrior() const { return (DNode<TYPE> *)Prior; }
  51.   DNode<TYPE> *GetNext() { return (DNode<TYPE> *)Next; }
  52.   const DNode<TYPE> *GetNext() const { return (DNode<TYPE> *)Next; }
  53.  
  54. public:
  55.   TYPE Data;
  56. };
  57.  
  58. // (D)oubly (L)inked (L)ist class 
  59. template<class TYPE>
  60. class DLList : public DLListBase
  61. {
  62. public:
  63.   DLList() { }
  64.   virtual ~DLList();
  65.   DLList(const DLList<TYPE> &X);
  66.   void operator=(const DLList<TYPE> &X);
  67.  
  68. public:
  69.   int Copy(const DLList<TYPE> &List);
  70.   int Cat(const DLList<TYPE> &X) { return DLListBase::Cat(X); }
  71.   const DNode<TYPE> *Find(const TYPE &X, const DNode<TYPE> *ptr=0) const;
  72.   DNode<TYPE> *Find(const TYPE &X, DNode<TYPE> *ptr=0);
  73.   int Delete(DNode<TYPE> *Node, TYPE *X = 0);
  74.   int DeleteFront(TYPE *X = 0);
  75.   int DeleteBack(TYPE *X = 0);
  76.   DNode<TYPE> *StoreNode(const TYPE &X);
  77.   DNode<TYPE> *AddToFront(const TYPE &X);
  78.   DNode<TYPE> *AddToBack(const TYPE &X);
  79.   DNode<TYPE> *AddBefore(const TYPE &X, DNode<TYPE> *Node);
  80.   DNode<TYPE> *AddAfter(const TYPE &X, DNode<TYPE> *Node);
  81.   DNode<TYPE> *GetHeader() { return(DNode<TYPE> *) this; }
  82.   const DNode<TYPE> *GetHeader() const { return(DNode<TYPE> *) this; }
  83.   DNode<TYPE> *GetFront() { return(DNode<TYPE> *)DLListBase::GetFront(); }
  84.   DNode<TYPE> *GetBack() { return (DNode<TYPE> *)DLListBase::GetBack(); }
  85.   
  86.   const DNode<TYPE> *GetFront() const { // Read only version
  87.     return(DNode<TYPE> *)DLListBase::GetFront();
  88.   }
  89.  
  90.   const DNode<TYPE> *GetBack() const { // Read only version
  91.     return (DNode<TYPE> *)DLListBase::GetBack();
  92.   }
  93.  
  94.   int IsHeader(const DNode<TYPE> *Node) const {
  95.     return DLListBase::IsHeader(Node);
  96.   }
  97.   TYPE *GetFrontNode() {
  98.     DNode<TYPE> *ptr = (DNode<TYPE> *)DLListBase::GetFront();
  99.     return IsHeader(ptr) ? 0 : &(ptr->Data);
  100.   }
  101.  
  102.   const TYPE *GetFrontNode() const {
  103.     DNode<TYPE> *ptr = (DNode<TYPE> *)DLListBase::GetFront();
  104.     return IsHeader(ptr) ? 0 : &(ptr->Data);
  105.   }
  106.  
  107.   TYPE *GetBackNode() {
  108.     DNode<TYPE> *ptr = (DNode<TYPE> *)DLListBase::GetBack();
  109.     return IsHeader(ptr) ? 0 : &(ptr->Data);
  110.   }
  111.  
  112.   const TYPE *GetBackNode() const {
  113.     DNode<TYPE> *ptr = (DNode<TYPE> *)DLListBase::GetBack();
  114.     return IsHeader(ptr) ? 0 : &(ptr->Data);
  115.   }
  116.  
  117. public:
  118.   void InsertBefore(DNode<TYPE> *A, DNode<TYPE> *B) {
  119.     DLListBase::InsertBefore(A, B);
  120.   }
  121.  
  122.   void InsertAfter(DNode<TYPE> *A, DNode<TYPE> *B) {
  123.     DLListBase::InsertAfter(A, B);
  124.   }
  125.  
  126.   void AttachToFront(DNode<TYPE> *Node) {
  127.     DLListBase::AttachToFront(Node);
  128.   }
  129.  
  130.   void AttachToBack(DNode<TYPE> *Node) {
  131.     DLListBase::AttachToBack(Node);
  132.   }
  133.  
  134.   DNode<TYPE> *RmvFront() {
  135.     return(DNode<TYPE> *)(DLListBase::RmvFront());
  136.   }
  137.  
  138.   DNode<TYPE> *Rmv(DNode<TYPE> *Node) {
  139.     return(DNode<TYPE> *)(DLListBase::Rmv(Node));
  140.   }
  141.  
  142.   DNode<TYPE> *RmvBack() {
  143.     return(DNode<TYPE> *)(DLListBase::RmvBack());
  144.   }
  145.  
  146. protected:
  147.   virtual DNode<TYPE> *AllocNode(const TYPE &X);
  148.   virtual DNodeBase *DupNode(const DNodeBase *Node);
  149.   virtual void FreeNode(DNodeBase *Node);
  150.  
  151. public: // Overloaded operators
  152.   int operator+=(const DLList<TYPE> &X) { return Cat(X); }
  153. };
  154.  
  155. template<class TYPE>
  156. DLList<TYPE>::~DLList()
  157. {
  158.   Clear();
  159. }
  160.  
  161. template<class TYPE>
  162. DLList<TYPE>::DLList(const DLList<TYPE> &X)
  163. {
  164.   Copy(X);
  165. }
  166.  
  167. template<class TYPE>
  168. void DLList<TYPE>::operator=(const DLList<TYPE> &X)
  169. {
  170.   Copy(X);
  171. }
  172.  
  173. template<class TYPE>
  174. int DLList<TYPE>::Copy(const DLList<TYPE> &List)
  175. {
  176.   return DLListBase::Copy(List);
  177. }
  178.  
  179. template<class TYPE>
  180. DNode<TYPE> *DLList<TYPE>::AllocNode(const TYPE &X)
  181. {
  182.   return new DNode<TYPE>(X);
  183. }
  184.  
  185. template<class TYPE>
  186. DNodeBase *DLList<TYPE>::DupNode(const DNodeBase *Node)
  187. {
  188.   return AllocNode(((DNode<TYPE> *)Node)->Data);
  189. }
  190.  
  191. template<class TYPE>
  192. void DLList<TYPE>::FreeNode(DNodeBase *Node)
  193. {
  194.   delete((DNode<TYPE> *)Node);
  195. }
  196.  
  197. template<class TYPE>
  198. const DNode<TYPE> *DLList<TYPE>::
  199. Find(const TYPE &X, const DNode<TYPE> *ptr) const
  200. // Returns the first node having an element that matched X
  201. {
  202.   if(ptr == 0) ptr = GetFront();
  203.  
  204.   while(!IsHeader(ptr)) { // Scan until end of list
  205.     if(ptr->Data == X) return ptr; // Match found
  206.     ptr = ptr->GetNext();
  207.   }
  208.   return 0; // No match
  209. }
  210.  
  211. template<class TYPE>
  212. DNode<TYPE> *DLList<TYPE>::Find(const TYPE &X, DNode<TYPE> *ptr)
  213. // Returns the first node having an element that matched X
  214. {
  215.   if(ptr == 0) ptr = GetFront();
  216.  
  217.   while(!IsHeader(ptr)) { // Scan until end of list
  218.     if(ptr->Data == X) return ptr; // Match found
  219.     ptr = ptr->GetNext();
  220.   }
  221.   return 0; // No match
  222. }
  223.  
  224. template<class TYPE>
  225. int DLList<TYPE>::Delete(DNode<TYPE> *Node, TYPE *X)
  226. {
  227.   DNode<TYPE> *ptr = Rmv(Node);
  228.   if(ptr) {
  229.     if(X) *X = ptr->Data; // Copy Data into X if X != 0
  230.     FreeNode(ptr);
  231.     return 1; // Return 1 if successful
  232.   }
  233.   return 0; 
  234. }
  235.  
  236. template<class TYPE>
  237. int DLList<TYPE>::DeleteFront(TYPE *X)
  238. {
  239.   DNode<TYPE> *ptr = RmvFront();
  240.   if(ptr) {
  241.     if(X) *X = ptr->Data; // Copy Data into X if X != 0
  242.     FreeNode(ptr);
  243.     return 1; // Return 1 if successful
  244.   }
  245.   return 0; 
  246. }
  247.  
  248. template<class TYPE>
  249. int DLList<TYPE>::DeleteBack(TYPE *X)
  250. {
  251.   DNode<TYPE> *ptr = RmvBack();
  252.   if(ptr) {
  253.     if(X) *X = ptr->Data; // Copy Data into X if X != 0
  254.     FreeNode(ptr);
  255.     return 1; // Return 1 if successful
  256.   }
  257.   return 0; 
  258. }
  259.  
  260. template<class TYPE>
  261. DNode<TYPE> *DLList<TYPE>::StoreNode(const TYPE &X)
  262. {
  263.   DNode<TYPE> *ptr = AllocNode(X);
  264.   if(ptr) AttachToBack(ptr);
  265.   return ptr; // Return a pointer to the node added
  266. }
  267.  
  268. template<class TYPE>
  269. DNode<TYPE> *DLList<TYPE>::AddToFront(const TYPE &X)
  270. {
  271.   DNode<TYPE> *ptr = AllocNode(X);
  272.   if(ptr) AttachToFront(ptr);
  273.   return ptr; // Return a pointer to the node added
  274. }
  275.  
  276. template<class TYPE>
  277. DNode<TYPE> *DLList<TYPE>::AddToBack(const TYPE &X)
  278. {
  279.   DNode<TYPE> *ptr = AllocNode(X);
  280.   if(ptr) AttachToBack(ptr);
  281.   return ptr; // Return a pointer to the node added
  282. }
  283.  
  284. template<class TYPE>
  285. DNode<TYPE> *DLList<TYPE>::AddBefore(const TYPE &X, DNode<TYPE> *Node)
  286. {
  287.   DNode<TYPE> *ptr = AllocNode(X);
  288.   if(ptr) InsertBefore(Node